Inside Macintosh: QuickDraw GX Printing /

Chapter 2 - Core Printing Features / Core Printing Features Reference

Functions / Creating and Managing Job Objects

GXUnflattenJob

You can use the GXUnflattenJob function to unflatten a job object that you previously flattened using the GXFlattenJob function.

gxJob GXUnflattenJob (gxJob aJob,
                     gxPrintingFlattenProc aPrintingFlattenProc,
                     void *aVoid);

aJob

A reference to the job object to be unflattened.

aPrintingFlattenProc

A pointer to a flattening function.

aVoid

A reference variable passed to the flattening function.

function result

The unflattened job object.

DESCRIPTION

The GXUnflattenJob function provides your application with a mechanism for retrieving all information associated with a job object by executing an application-supplied function. In the aPrintingFlattenProc parameter, you specify a pointer to an unflattening function. QuickDraw GX calls your unflattening function multiple times as it retrieves job object-related data from disk.

In the aJob parameter, you specify a job object in which to place the unflattened job object data. You can specify nil in this parameter to allow QuickDraw GX to create and return a job object for you.

RESULT CODES

gxSegmentLoadFailedErr	A required code segment could not be found, or there was not enough memory to load it.
gxFlattenVersionTooNew	An attempt to unflatten a job object that was flattened using a later version of QuickDraw GX.
gxPaperTypeNotFound	The paper-type object cannot be located.
collectionVersionErr	Version of the collection object is not compatible with the current version of the Collection Manager.

SEE ALSO

Listing 2-10 on page 2-30 shows an example of how to use the GXUnflattenJob function.

You specify a function to save a job object by using the GXFlattenJob function, which is described on page 2-57.

Main | Page One | What's New | Apple Computer, Inc. | Find It | Contact Us | Help